[Top] [Prev] [Next] [Bottom]
[Contents]
SaRegisterHtmlActivator
Registers a lookup string so that a callback function can be invoked from an HTML client.
#include "SaRnHtml.h"
typedef void (*SaHtmlCallback)();
int SaRegisterHtmlActivator(char* actName,SaHtmlCallback call);
Arguments
- actName
- The name of the activator that will be used to look up the callback function when your cgi executable is executed.
- call
- A pointer to an activator callback function.
Return Values
Returns -1 if actName is NULL or an empty string or if call is NULL.
Registers a lookup string so that a callback function can be invoked from an HTML client. Returns -1 if actName is NULL, or an empty string, or if call is NULL. When Sapphire/Web writes the URLs for the Anchor HREFs that are bound, or for your bound forms, a string is inserted which will be processed by your cgi so that the appropriate callback function can be called. For Anchors this string is contained in the HREF after "?FNC=". For example:
<A HREF="http://cezanne/cgi-
bin//s.cgi?FNC=Anchor1__Atestmod_html" >Scott</A>
For forms, this string is contained in the VALUE part of a hidden form element whose name is "SaSubmitName". For example:
<INPUT TYPE="hidden" NAME="SaFormName"
VALUE="Try1__Ftestmod_html">
- Note: If this function is called more than once in the same
actName string, only the first registered callback is dispatched. There is no "unregister". For example:
SaRegisterHtmlActivator("GroupBy__Astart_html",AGroupBy);
This call is generated automatically by Sapphire/Web through use of the Results Detail Dialog.
[Top] [Prev] [Next] [Bottom]
[Contents]
info@bluestone.com
Copyright © 1997, Bluestone. All rights
reserved.